home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 41 / Amiga Format CD41 (1999-06)(Future Publishing)(GB)[!][issue 1999-07].iso / -seriously_amiga- / cd-rom / acdb / acdb_pl.readme < prev    next >
Text File  |  1999-04-28  |  9KB  |  237 lines
  1.  
  2.   ACDB v1.1 (19.04.99)
  3.   FREEWARE
  4.   ©1999, Piotr Gapiïski <narg@polbox.com>
  5.  
  6.  
  7. [ADNOTACJE]
  8.   WERSJA BETA DO TESTOWANIA!
  9.   AUTOR NIE PONOSI ODPOWIEDZIALNOÔCI ZA EWENTUALNE STRATY SPOWODOWANE
  10.   UÛYTKOWANIEM PROGRAMU!
  11.  
  12.  
  13. [PROGRAM]
  14.   acdb (amiga cd [data] base) to program umoûliwiajâcy zaimportowanie opisów pîyt
  15.   kompaktowych cd-da (audio) z internetowej bazy danych i zapisanie na dysku lokalnym
  16.   w formacie zgodnym ze SCDP (format rozpoznawany przez wiëkszoôê amigowych
  17.   cd-playerów).
  18.  
  19.  
  20. [WYMAGANIA]
  21.   1. komputer AMIGA, OSv37+ (2.04+)
  22.   2. TCP/IP (bsdsocket.library v4+)
  23.   3. reqtools.library v38+
  24.   4. easyrexx.library v3+
  25.      biblioteka ta moûe byê rozpowszechniana na zasadach public-domain,
  26.      prawa autorskie naleûâ do ©1996 Ketil Hunn
  27.  
  28.  
  29. [ZMIANY]
  30.   acdb 1.1 (19.04.99)
  31.   1. progress indicator dziaîa takûe przy ôciâganiu opisów komendâ Arexx'a DOWNLOAD IDFILE
  32.   2. po zakoïczeniu procesu pobierania opisów wyôwietlane jest podsumowanie
  33.      (iloôê plików w katalogu TEMP, iloôê plików przeszukanych w CDDB, iloôê plików znalezionych
  34.      w CDDB)
  35.   3. jeûeli CLEANTEMP=no to po poprawnym ôciâgniëciu opisów plik z katalogu TEMP bëdzie
  36.      miaî zmienionâ nazwë przez dodanie sufiksu .ok
  37.  
  38.  
  39. [URUCHOMIENIE]
  40.   Program moûna uruchamiaê zarówno z poziomu CLI jak i WORKBENCH'a z tym, ûe w tym
  41.   drugim przypadku moûliwe jest przekazanie przez TOOLTYPE ikonki dodatkowych
  42.   parametrów.
  43.  
  44.   Workbench:
  45.     DEVICE=<device name>
  46.     nazwa sterownika napëdu CD-ROM, domyôlnie cd.device
  47.  
  48.     UNIT=<number>
  49.     numer urzâdzenia jako które jest podîâczony CD-ROM, domyôlnie 0
  50.  
  51.     HOST=<cddb host>
  52.     adres internetowego serwera cddb, domyôlnie www.cddb.com
  53.     listë serwerów moûna pobraê z internetu dziëki programowi acdb_hosts
  54.     znajdujâcego sië w archiwum z programem
  55.  
  56.     PORT=<cddb port>
  57.     port przez który bëdzie nawiâzana komunikacja z serwerem cddb, domyôlnie 80
  58.  
  59.     CDTIME=<yes|NO>
  60.     decyduje o umieszczaniu o opisach pîyt pobranych z internetu caîkowitego 
  61.     czasu trwania pîyty, domyôlnie NO (nie)
  62.  
  63.     TRACKTIME=<yes|NO>
  64.     decyduje o umieszczaniu o opisach pîyt pobranych z internetu czasów trwania
  65.     poszczególnych utworów, domyôlnie NO (nie)
  66.  
  67.     CLEANTEMP=<YES|no>
  68.     decyduje czy pliki tymczasowe (zapisywane w katalogu TEMP) majâ byê, po 
  69.     pomyôlnym pobraniu opisów z internetu, kasowane czy teû nie, domyôlnie YES (tak)
  70.     przy opcji 'no', pliki dla których poprawnie ôciâgniëto opisy z internetu bëdâ
  71.     miaîy zmienionâ nazwë na IDxxxxxxxx.ok
  72.  
  73.     DISKS=<dir>
  74.     katalog do którego bëdâ zapisywane pobrane z internetu opisy pîyt kompaktowych,
  75.     domyôlnie PROGDIR:disks
  76.  
  77.     TEMP=<dir>
  78.     katalog do którego bëdâ zapisywane wszystkie pliki tymczasowe potrzebne do
  79.     prawidîowego funkcjonowania programu, domyôlnie PROGDIR:temp
  80.  
  81.     ICON=<file without .info>
  82.     nazwa pliku (bez rozszerzenia .info), który bëdzie uûywany gdy program
  83.     bëdzie zikonifikowany, domyôlnie bëdzie uûywana ikonka programu lub,
  84.     w przypadku uruchomienia z poziomu CLI, PROGDIR:acdb
  85.  
  86.     PUBSCREEN=<pub screen name>
  87.     nazwa ekranu publicznego na którym program ma sië uruchomiê,
  88.     domyôlnie ekran workbench'a
  89.  
  90.   CLI:
  91.     Uruchomienie programu z poziomu CLI spowoduje przyjëcie przez program
  92.     paramterów domyôlnych (nie ma moûliwoôci ich zmiany).
  93.  
  94.  
  95. [PROGRAM]
  96.   Program umoûliwia (prawie) automatyczne pobieranie opisów pîyt audio z
  97.   internetowej bazy danych CDDB. Tok postëpowania jest nastëpujâcy:
  98.  
  99.   1. przygotowanie identyfikatorów pîyt, których opisy naleûy
  100.      z internetu pobraê (OFFLINE)
  101.   2. pobranie opisów wczeôniej przygotowanych pîyt (ONLINE)
  102.  
  103.   PRZYGOTOWANIE IDENTYFIKATORÓW
  104.     Dla kaûdej pîyty program tworzy specjalny plik zawierajâcy wszystkie dane
  105.     niezbëdne do pobierania opisów. Pliki te tworzy sië przez naciôniëcie
  106.     przycisku 'WriteID' - program sprawdza czy opis dla danej pîyty nie jest juû
  107.     pobrany (sprawdza w katalogu DISKS) i jeûeli nie to zapisuje dane w katalogu
  108.     TEMP.
  109.  
  110.   POBRANIE OPISÓW
  111.     Po naciônieciu przycisku 'Download' program bëdzie sië staraî pobraê
  112.     wszystkie opisy pîyt dla których przygotowano pliki identyfikacyjne.
  113.     Moûe sië zdarzyê, ûe identyfikator pîyty nie jest jednoznaczy tzn. jeden
  114.     identyfikator okreôla kilka pîyt w bazie CDDB - wtedy program pobierze
  115.     WSZYSTKIE pasujâce opisy i zapisze z przyrostkiem okreôlajâcym numer kopii
  116.     (np. IDxxxxxxxx.1).
  117.     Jeûeli z jakichkolwiek przyczyn nie byîo moûliwe pobranie opisów, program
  118.     albo przerwie dziaîanie sygnalizujâc to odpowiednim komunikatem albo
  119.     przez dodanie przyrostka zmieni nazë pliku CDID (z tatalogu TEMP) na
  120.     nazwë opisujâcâ bîâd (np. IDxxxxxxxxx.corrupt czy .not found).
  121.     Pliki takie sâ przez program pomijane przy pobieraniu opisów.
  122.  
  123.     Po pobraniu wszystkich moûliwych opisów dla danego identyfikatora pîyty
  124.     odpowiedni plik z katalogu TEMP zostaje skasowany (zobacz tez
  125.     TOOLTYPE/CLEANTEMP).
  126.     Podczas pobierania opisów program wyôwietla informacje o stopniu
  127.     zaawansowania procesu umoûliwiajâc takûe przerwanie operacji (Abort).
  128.  
  129.  
  130. [PORT AREXX'A]
  131.   Program posiada port Arexx'a o nazwie ACDB[.X], gdzie .X jest opcjonalnym
  132.   numerem kopii programu (ACDB, ACDB.1, ACDB.2, itp.)
  133.   Jak na razie dostëpne sâ komendy:
  134.  
  135.   QUIT
  136.     koïczy dziaîanie programu
  137.  
  138.   TRAY OUT
  139.   TRAY IN
  140.     komenda obsîugujâca podajnik (tray) napëdu CD umoûliwiajâc jej wysuniëcie
  141.     (OUT) bâdú teû schowanie (IN).
  142.  
  143.   CDID FORCE STORE
  144.   CDID STORE
  145.   CDID DOWNLOAD
  146.     obsîuga plików CDID dziëki której plik identyfikujâcy pîytë moûna zapisaê
  147.     do katalogu TEMP (STORE) lub teû od razu pobraê z internetu opis pîyty
  148.     znajdujâcej sië w napëdzie CDROM (DOWNLOAD);
  149.     podczas zapisywania pliku program sprawdza czy dla pîyty o takim
  150.     identyfikatorze juû istnieje opis (w katalogu DISKS) - jeûeli istnieje
  151.     to zostanie wyôwietlony requester z prosbâ o potwierdzenie operacji;
  152.     uûycie parametru (FORCE) powoduje natychmiastowy zapis pliku bez
  153.     wczeôniejszego testowania
  154.  
  155.   DOWNLOAD CDID
  156.   DOWNLOAD ALL
  157.     wymusza poîâczenie z internetowâ bazâ CDDB i pobranie opisu pîytki
  158.     okreôlonej przez nazwë pliku identyfikacyjnego (z katalogu TEMP)
  159.     lub teû wszystkich pîyt dla których w katalogu TEMP przygotowano pliki (ALL);
  160.     UWAGA! przy podawaniu nazwy pliku naleûy pamiëtaê o ôcieûce dostëpu
  161.  
  162.   GET COMMANDLIST
  163.   GET AUTHOR
  164.   GET COPYRIGHT
  165.   GET VERSION
  166.   GET LASTERROR
  167.     zwraca listë wszystkich komend (COMMANDLIST), które program rozpoznaje,
  168.     identyfikator autora programu (AUTHOR), informacje na temat praw autorskich do
  169.     programu (COPYRIGHT), informacje na temat wersji programu (VERSION), informacje
  170.     o wykrytym ostatnio bîëdzie w przetwarzaniu komend Arexx'a (LASTERROR)
  171.  
  172.   przykîad:
  173.     /* test
  174.     */
  175.     OPTIONS RESULTS
  176.     ADDRESS ACDB
  177.  
  178.     CDID DOWNLOAD
  179.     IF (result = 0) THEN DO
  180.       GET LASTERROR
  181.       SAY result
  182.     END
  183.  
  184.  
  185. [TIPSY]
  186.   1. Program zapisuje poîoûenie i wymiary gîównego okienka do pliku
  187.      ENV:acdb
  188.      moûna wiëc plik ten przekopiowaê do katalogu ENVARC: a zawarte w nim
  189.      ustawienia bëdâ ustawieniami domyôlnymi programu
  190.   2. Jeûeli podczas deikonifikacji program nie wykryje ekranu publicznego na
  191.      którym uprzednio byî uruchomiony, to do czasu ponownego pojawienia
  192.      sië ûâdanego ekranu bëdzie korzystaî z domyôlnego ekranu publicznego
  193.      systemu (najczëôciej jest to ekran workbench'a)
  194.   3. Jeûeli program jest uruchomiony z CLI to naciôniëcie klawiszy
  195.      CTRL-C spowoduje zakoïczenie dziaîania programu, CTRL-F spowoduje
  196.      deikonifikacje a CTRL-D przerwanie pobierania danych z internetu
  197.  
  198.  
  199. [ZNANE BÎËDY]
  200.   Do tej chwili (acdb, v1.1, 19.04.99) zostaîy wykryte nastëpujâce bîëdy:
  201.   1. opisy pîytek nie zawierajâ polskich znaków (i raczej nie bëdâ ich zawieraîy)
  202.      to raczej nie jest bîâd - po prostu serwery CDDB obsîugujâ tylko kod Latin-1
  203.   2. testowanie naciôniëcia przycisku Abort nastëpuje tylko w przerwach
  204.      miëdzy odbiorem poszczególnych paczek danych z internetu (100 bajtowych)
  205.      wiëc nie zawsze naciôniëcie przycisku da natychmiastowy efekt
  206.   3. jeûeli program jest zikonifikowany to nie bëdzie dziaîaî port Arexx'a
  207.  
  208.  
  209. [KONTAKT Z AUTOREM]
  210.   Wszelkie raporty o bîëdach, sugestie i komentarze proszë przesyîaê na adres:
  211.   narg@polbox.com
  212.   http://free.polbox.pl/n/narg
  213.  
  214.  
  215. [PODZIËKOWANIA]
  216.   Wielkie dziëki dla beta-testerów:
  217.   *  Artur Bychowski <jobo@zt.suwalki.tpsa.pl>
  218.   *  Michaî Durys <misha@femina.com.pl>
  219.   *  Piotr Pawîow <pp@union.org.pl>
  220.   *  Roman Dobosz <gryf@elysium.pl>
  221.  
  222.  
  223. [TECHNICZNE INFORMACJE]
  224.   Program powstaî w jëzyku AmigaE i uûywa nastëpujâcych moduîów:
  225.   1. EASYGUI, © Wouter, Jason
  226.   2. ICONIFY PLUGIN, © Piotr Gapinski
  227.   3. AFC/PARSE, © Fabio Rotondo
  228.   4. FILE, © Wouter
  229.  
  230.   Podczas pisania programu byîy wykorzystywane nastëpujâce materiaîy:
  231.   1. @(#)cddb.howto 1.27 (98/12/09)
  232.   2. (SCSI) X3T9.2 WORKING DRAFT (7-SEP-93)
  233.   3. RFC-1945 (HTTP1.0)
  234.   4. amiTCP/IP HTTP/GET example
  235.   5. BGUI BGPlayer example
  236.  
  237.